Skip to content

Specification: PowerShell Module Full Parity#6290

Draft
denelon wants to merge 5 commits into
microsoft:masterfrom
denelon:spec/powershell-module-parity
Draft

Specification: PowerShell Module Full Parity#6290
denelon wants to merge 5 commits into
microsoft:masterfrom
denelon:spec/powershell-module-parity

Conversation

@denelon

@denelon denelon commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

📖 Description

Specification for achieving full functional parity between the WinGet PowerShell modules and the CLI.

Revised after review to reflect the actual shipping source rather than an overstated gap list. Key corrections:

  • Documents what already exists in both Microsoft.WinGet.Client and Microsoft.WinGet.Configuration (download = Export-WinGetPackage, repair = Repair-WinGetPackage, configure test/show/list/abort/delete, user/admin settings, -Scope).
  • Scopes the real command gaps to: pin management (Add/Get/Remove/Reset-WinGetPin) and package list import/export (winget export/import, #5041) — distinct from Export-WinGetPackage (download).
  • Reframes elevated/SYSTEM context as reliability bugs in the existing custom activation paths (#5991, #6042), not missing features.
  • Fixes the architecture: Microsoft.WinGet.Configuration uses Microsoft.Management.Configuration, not Microsoft.Management.Deployment.
  • Models pins with a PinType (Pinning/Blocking/Gating) and drops deep COM interface design per review feedback (keeps cmdlet inputs/outputs only).
  • Removes the module-consolidation future consideration (the two modules do not overlap).
  • Adds an issue-tracked enhancement backlog for existing cmdlets.

Authored with GitHub Copilot assistance.

🔗 References

Related Issues:

Related PR:

🔍 Validation

Spec document — no code changes to validate.

✅ Checklist

📋 Issue Type

  • Bug fix
  • Feature
  • Task
Microsoft Reviewers: Open in CodeFlow

Specification for achieving full functional parity between the WinGet
PowerShell module and the CLI, including SYSTEM context support,
new cmdlets for configure/pin/download/repair/settings operations,
and enhanced source management.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md
Demitrius Nelon and others added 2 commits June 17, 2026 13:01
WinGet ships two separate PowerShell modules:
- Microsoft.WinGet.Client (package management)
- Microsoft.WinGet.Configuration (configuration/DSC operations)

Update spec to clearly delineate which cmdlets belong to which module,
add Configuration-specific gaps (history, abort, delete), update the
architecture diagram, and note module consolidation as a future
consideration.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove detailed IDL interface definitions (too implementation-level
  for a spec; keep high-level description of needed COM surface)
- Use PinType property instead of IsBlocking for future expandability
  (supports checking gating pins too)
- Add PR microsoft#6190 (Configuration module improvements) to Resources

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Comment thread doc/specs/#6288 - PowerShell Module Full Parity.md Outdated
Rewrite the PowerShell parity spec against the actual shipping source.
Most CLI surface already has cmdlets (download=Export-WinGetPackage,
repair=Repair-WinGetPackage, configure test/show/list/abort/delete,
settings, -Scope). Scope the real gaps to pin management and package
list import/export. Reframe elevated/SYSTEM context as reliability bugs
in the existing activation paths, not missing features. Fix the
architecture to show Configuration uses Microsoft.Management.Configuration.
Model pins with PinType (incl. gating) and drop deep COM interface design
per review. Remove the module-consolidation idea.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

This comment has been minimized.

Resolve check-spelling failures for the PowerShell parity spec.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants